home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / diskutil / tapebios.zoo / docs / tapebios.doc < prev    next >
Encoding:
Text File  |  1992-03-22  |  4.0 KB  |  80 lines
  1. TapeBIOS driver software Version 1.5
  2. ====================================
  3.  
  4.     Well, Here it is. A TapeBIOS for the Atari ST and Atari TT computers,
  5. as long as the DMA registers on the TT haven't moved since the ST days. The
  6. TapeBIOS program allows these Atari machines to talk to a SCSI tape drive
  7. connected through the DMA bus(not the SCSI bus of the TT).
  8.  
  9.     Provided in this package is quite a few extras. i.e. programmers docs,
  10. support programs, to use and to be used as examples on how to access the 
  11. capabilities of the TapeBIOS software. Also provided is the necessary include
  12. files and library code for the GNU 'C' compiler, i.e. TAPEBIND.H in the include
  13. directory contains the necessary bindings to include into your 'C' programs.
  14.  
  15.     The TapeBIOS software installs itself into the TRAP #10 vector, via the
  16. XBRA protocol and gives itself and ID of 'TAPE'. TapeBIOS also installs itself
  17. into the COOKIE JAR, again with an ID of 'TAPE', the value contained in the jar
  18. is the current version number, which is v1.5. If no COOKIE JAR exists then
  19. TapeBIOS will create one with space for 20 cookies, but if the jar is full
  20. then TapeBIOS copies the old jar into a new one with space for 20 extra cookies
  21. and then installs itself into this new jar leaving 19 cookies spare.
  22.  
  23. How do we install this wonderful software ?
  24. ===========================================
  25.  
  26.     Well, to install TapeBIOS a few rules must be first met. A file must
  27. accompany TapeBIOS for it to function correctly and install properly. This 
  28. file is TAPEBIOS.INF. This file currently contains just two numbers for 
  29. TapeBIOS to operate. These values are the SCSI ID or address of your tape
  30. streamer and a timeout value.
  31.  
  32.     The timeout value is a number between 0 and 65535, but must be entered
  33. in the TAPEBIOS.INF file as a 5 digit number (e.g. for a timeout value of 10,
  34. the number must be entered in TAPEBIOS.INF as 00010). The timeout is a small
  35. delay before the next SCSI command is issued to the tape streamer. This is 
  36. because some streamers take a small amount of time to execute a command and
  37. return the appropriate values, but this does vary from vendor to vendor. Again,
  38. check the DRIVES.TST file for more information.
  39.  
  40.     Check the example TAPEBIOS.INF file in the bios directory to help you
  41. install TapeBIOS.
  42.  
  43. Testing TapeBIOS with your streamer
  44. ===================================
  45.  
  46.     If you find that you have a tape streamer not listed in DRIVES.TST,then
  47. to make sure that TapeBIOS can talk to your tape drive, run the TAPETEST.TOS
  48. program located in the test directory. If all goes well TapeBIOS will run 
  49. through the complete test without problems, if it does please notify me that
  50. your tape streamer works.
  51.  
  52.     If not, then the troubleshooting phase starts. If you are one of the
  53. unlucky ones in which TapeBIOS cannot talk to your tape streamer then try
  54. some of the following to remedy the problem.
  55.  
  56.     1. If the error is spuradic, i.e. different errors every time you
  57.        execute TAPETEST.TOS, then try increasing the timeout value. The 
  58.        best idea is to increase to a maximum then re-run TAPETEST.TOS.
  59.        If the problem still occurs try the number 2.
  60.  
  61.     2. If you have the GNU 'C' compiler then try removing the offending
  62.        command from TAPETEST.C and re-compile. Then re-run TAPETEST.TOS
  63.        and see how far the test gets, making note of commands removed
  64.        and any errors that appeared because of the offending command.
  65.  
  66.     Then, if all goes well and the test finishes, report back to me if
  67. you think you have found a problem or to update me on any new information that
  68. doesn't appear in the file DRIVES.TST. Your input is very valuable to helping
  69. improve TapeBIOS.
  70.  
  71. DISCLAIMER: I cannot be held responsible for any data lost through the misuse
  72. of using this package. Although I use this software every day and this setup
  73. works well with my system. I would be happy to fix any problems found using
  74. this software, but please do not flame me through misuse or loss of data using
  75. the package.
  76.  
  77. Alan Hourihane.
  78. email: alanh@logitek.co.uk
  79. 15/3/92.
  80.